home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / telecomm / zmdm168.lzh / zmdm.doc < prev    next >
Text File  |  1990-10-02  |  31KB  |  792 lines
  1.     zmdm.doc, v1.6 ++jrb
  2.  
  3.                 ACKNOWLEDGEMENTS
  4.  
  5.     ZMDM was derived from rz/sz for Unix  posted by 
  6.     Chuck Forsberg (...!tektronix!reed!omen!caf ). We
  7.     thank him for his excellent code, and for giving
  8.     us permission to use and distribute his code and
  9.     documentation.
  10.  
  11.     The code for detecting baud rate at startup is courtesy
  12.     of Brian Katzung (katzung@laidbak.UUCP). Thanks very
  13.     much!
  14.  
  15.     Andy Nicola did a lot of testing of the new features.
  16.     Thank You very much!
  17.  
  18.     Thanks to the many users on the net who wrote in.
  19.  
  20.     It is possible to run @38.4K or higher baud rates, the changes
  21.     for this are simple. however, not all ST's run reliably at those
  22.     rates, so i left those options out.
  23.  
  24.     The phones module is totally compatible with our earlier program
  25.     xmdm, so phone directories created with xmdm can be used with zmdm.
  26.  
  27. ----------------------------------------------------------------------------
  28.     Enhancements since V1.67
  29.         o CPS reporting has changed. cps now is the effective
  30.         cps, on receive it includes the time to write the file.
  31.         on send it is the file send time (including read time).
  32.         note: on send the effective cps can be higher than the
  33.         baud rate can possible send. this discrepancy is because
  34.         of buffering.
  35.         o increased send buffer size
  36.         o minor bug fixes
  37.  
  38.     Enhancements since V1.64
  39.         o Updated protocol
  40.         o fixed some long/short int problems (due to strlen being
  41.           size_t for gcc lib)
  42.         o cursor is not turned on automatically. if you are running
  43.           this from the desktop and want the cursor turned on,
  44.           name the executable files with .tos or .ttp extensions.
  45.             o hi-rez toggle is preserved (ie: if you changed it
  46.               within zmdm, it is restored on exit).
  47.           Note: autowrap, and screen color inversion are not
  48.           preserved on purpose. if you want to change that
  49.           just look in main.c.
  50.  
  51.         o Bug: still does not understand the concept of
  52.           daylight saving time, so the St files will be
  53.           an hour behind when downloaded.
  54.           (also note: there are some versions of this program
  55.            munged by someone else, floating around on various BBS
  56.            that totaly screw up date/time/protection. Settle only
  57.            for the origonal!)
  58.         o Newer versions of TurboSt seem to live well with
  59.           the 50 line mode. QuickSt also seems to be fine.
  60.  
  61.     Enhancements since V1.64:
  62.         o accept an optional command line arguement for
  63.           default phone directory file name. If not found
  64.           or is not specified, then it looks for the 
  65.           environment variable "PHONE". If found it will
  66.           use it, otherwise the first time it tries to
  67.           use a phone directory, it'll prompt for a filename.
  68.         o Stderr now should go to screen. This fix is in the
  69.           gnu library and not in zmdm per se. (this also
  70.           will enable people to run the standalone programs
  71.           from flash etc). This program is supposedly incompatible
  72.           with Shadow. I dont have shadow, so i dont know what the
  73.           incompatibilities are, however this program uses standard
  74.           Tos calls for everything, and works under all versions
  75.           of Tos, so i suspect the problem is with Shadow.
  76.         o check in under RCS (internal change).
  77.  
  78.     Enhancements since V1.62:  (last Usenet release).
  79.  
  80.         o Now looks for environment variable "PHONE"
  81.           for default phone directory file name. If
  82.           found it will be opened.
  83.  
  84.         o Gnu C compiler added. Requires V1.35 or better.
  85.  
  86.     Enhancements since V1.2:
  87.     
  88.         o Some cleanup, moved common things around.
  89.           Some cosmetic additions.
  90.  
  91.         o MWC 3.0 compatible. The sample MW makefiles
  92.           reflect the setup required for MWC  V 3.0.6.
  93.  
  94.         o Manx Aztec C compatible. Tested with V 3.6a
  95.           of the compiler. Produces the smallest code
  96.           of all the compilers tested. See config.h,
  97.           makefile.man and makefman.sta.
  98.           CAUTION: for MegaST and 4Meg ST owners--
  99.             The Manx Version will not work correctly
  100.           for you due to a bug in the start up file
  101.           -- we are still trying to figure out exactly
  102.           what the problem is!
  103.  
  104.         o Auto Baud Rate detection on startup:
  105.           Previously ZMDM would set the baud rate
  106.           to a compile time configurable rate on
  107.           startup (it needed to know the baud rate
  108.           to determine its default packet size). Thanks
  109.           to code contributed by Brian Katzung, now it
  110.           detects the baud rate on startup.
  111.           Of course you can set the baud rate
  112.           within ZMDM (by hitting '<HELP>'  'b' ).
  113.  
  114.         o Compile time option to use all available memory
  115.           as recv/send buffer. See DYNABUF, LEAVEALONE and
  116.           MINACC preprocessor symbols in config.h. If you
  117.           prefer to use a fixed size buffer, this is still
  118.           possible by not #define'ing DYNABUF and setting
  119.           BBUFSIZ. MegaST OK - thanks Andy Nicola.
  120.  
  121.         o Stand Alone versions of RZ and SZ can be made
  122.           by compiling the sources with the preprocessor
  123.           symbols 'STANDALONE' #define'ed. See the makefile
  124.           'MAKEFILE.STA' for more details.
  125.           Stand Alone versions DO NOT do any command line
  126.           argument expansions for wild cards or directories
  127.           (unlike the integrated ZMDM).
  128.           Stand Alone versions tested from within Gulam,
  129.           Flash and Intersect. Thanks to Andy Nicola for
  130.           testing these features.
  131.  
  132.         o Remote versions of ZMDM, RZ and SZ can be made by
  133.           compiling the sources with the preprocessor symbol
  134.           'REMOTE' #define'ed. A remote version listens and
  135.           does all its I/O thru the serial port. Of course
  136.           it has to be fired up from console. One of our
  137.           area BBS's provides this as a D/L option, where
  138.           the BBS program execs a remote ZMDM, and one you exit
  139.           you return back to the BBS program.
  140.  
  141.             o Added -B (note: uppercase B) option to both RZ and SZ.
  142.           the -B function is a binary mode override, that disregards
  143.           the extension when deciding the transfer mode. This is
  144.           useful when say you are backing up your whole disk
  145.           to say a Unix host. (backup the exact image of the files),
  146.           or doing St-to-St type transfers.
  147.         
  148.         o Now compatible with the PD DLIB library. The
  149.           pre-processor symbol DLIBS must be defined. Only
  150.           tested with the Alcyon version of the library.
  151.  
  152.         o Added the phone module (a simple dialer with a
  153.           telephone numbers directory). This module is
  154.           only compiled in if the preprocessor symbol
  155.           'PHONES' is #define'ed. For those of you who
  156.           are familiar with XMDM, this module was directly
  157.           ripped out of there, with a small bug fix that
  158.           prevented it from running under TurboSt.ACC.
  159.  
  160.         o Long packet lengths now allowed at slower baud rates
  161.           rather than insisting on using the default as the max
  162.           packet length. For instance
  163.             sz -l 1024 files..
  164.           will now send 1024 byte packets at low baud rates (<= 2400).
  165.           The corresponding change has been made to the unix
  166.           end of the software too.
  167.  
  168.         o TurboSt.ACC note:
  169.             The high rez toggle (25/50 lines) on a
  170.         monochrome monitor will NOT work is TurboSt.ACC is
  171.         installed. The problem is on the TurboSt.ACC end. Using
  172.         the high rez toggle does'nt cause any ill-effect, it just
  173.         does not do anything.
  174.           
  175.     Enhancements since V1.0:
  176.         o (This enhancement is only present when
  177.            you compile with the pre-processor symbol
  178.            `RECURSE' defined - see the makefile's)
  179.           sz now takes a  directory as an argument.
  180.           If the name of a directory is given as an
  181.           argument, then the contents of that directory
  182.           and all its subdirectories are sent. A new
  183.           option to sz is '-P <dir or file>'
  184.           (capital 'P' not 'p'), that
  185.           'prunes' the expansion of a directory. For
  186.           example if you wanted to send all the files
  187.           in the 'C' partition of your hard disk, except
  188.           the 'tmp', 'usr' and 'foo\bar' subdirectories, you would
  189.           issue the following command in the transfer
  190.           shell:
  191.  
  192.              sz -f -P c:\tmp -P c:\usr -P c:\foo\bar c:\
  193.  
  194.           Notice that you may specify multiple -P 'rune
  195.           options. The argument to the -P option may also be
  196.           the name of a file that you want to prune off.
  197.           Also note that to send full path names
  198.           to the remote end, the '-f' option is required,
  199.           otherwise the remote end will create all the
  200.           f